home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_NFF.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  2.6 KB  |  66 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-NFF
  3. .SH NAME
  4. imp_nff \- Haines NFF geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the Haines NFF
  8. geometry import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert a Haines NFF file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i nff -o wave filename.nff
  16. .PP
  17. To convert a Haines NFF file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i nff -in-nff-report-statistics = yes -o vrml filename.nff
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This geometry import converter reads in Eric Haines' Neutral File Format 
  25. (NFF) files. This file format is primarily used with the SPD package created 
  26. by Eric Haines (SPD is used to test ray tracing programs). Please note that 
  27. this converter does not read in the World Toolkit NFF file format which is 
  28. quite different from Haines' NFF format, nor does it read in the ENFF format 
  29. (an informal extension to the Haines' NFF file format).
  30. .PP
  31. .SH COMMAND LINE OPTIONS
  32. .PP
  33. The following options are specific to this import converter:
  34. .TP
  35. -i nff
  36. This is the optional command line option which specifies that the input data
  37. is in the Haines NFF file format (ASCII). If not 
  38. specified then the converter will try to guess the input file's format from 
  39. its file extension (.nff) and then from the contents of its file. 
  40. .TP
  41. -in-nff-report-statistics = [ yes | no ]
  42. If this option is enabled then the import converter will print out the number 
  43. of objects and polygons that were parsed from the file.
  44. .PP
  45. .SH CONVERSION PROCESS
  46. .PP
  47. This converter reads in all information from a Haines NFF file and converts 
  48. the data to internal representations. The conversions are described as 
  49. follows:
  50. .IP
  51. "v"  - viewing vectors and angles. These parameters are converted into a camera definition.
  52. .IP
  53. "l"  - positional light location. This is converted into a point light source.
  54. .IP
  55. "b"  - background color. This is converted into a uniform color background color scheme.
  56. .IP
  57. "f"  - object material properties. These are converted to equivalent an equivalent material definition.
  58. .IP
  59. "c"  - cone or cylinder primitive. Adds either a cone or cylinder object.
  60. .IP
  61. "s"  - sphere primitive. Adds a sphere object.
  62. .IP
  63. "p"  - polygon primitive & "pp" - polygonal patch primitive. All random polygons are collected in a long list then optimized and stored as an indexed polygon mesh primitive (memory efficient).
  64.  
  65.  
  66.